perm filename PUBMAC.DOC[2,TES] blob sn#002748 filedate 1972-06-06 generic text, type T, neo UTF8
June 6, 1972


                  T A B L E   O F   C O N T E N T S
                  _ _ _ _ _   _ _   _ _ _ _ _ _ _ _




                               SECTION                           PAGE




I      MACROS DECLARED IN `PUBMAC.DFS'

            I-A       FRACTION(NUMERATOR,DENOMINATOR) .  .  .  .  I.1

            I-B       SCRIPTS .  .  .  .  .  .  .  .  .  .  .  .  I.1

            I-C       GREEKS  .  .  .  .  .  .  .  .  .  .  .  .  I.1

            I-D       FORMAT  .  .  .  .  .  .  .  .  .  .  .  .  I.2

            I-E       STANDARD FRONT(SECPRINT, SSPRINT,
                              PAGEPRINT, INDEXCHAR)   .  .  .  .  I.2

            I-F       STANDARD BACK .  .  .  .  .  .  .  .  .  .  I.3


II     MACROS DECLARED BY `STANDARD FRONT'

            II-A      SEC(NAME)  .  .  .  .  .  .  .  .  .  .  . II.1

            II-B      SS(NAME)   .  .  .  .  .  .  .  .  .  .  . II.1
June 6, 1972


                              SECTION I
                              _______ _

                   MACROS DECLARED IN `PUBMAC.DFS'
                   ______ ________ __ ____________




Do not alter PUBMAC.DFS!  You may read it to see how the macros work.
To change them, copy them  to your manuscript first.  To use  them as
is, "REQUIRE PUBMAC.DFS[1,3]".



FRACTION(NUMERATOR,DENOMINATOR)
_______________________________


I-A.  Neither argument should contain control  characters, especially
not any of these:
          ↑ ↓ [ ] &

The character # is considered to be a space.

Input:
          {FRACTION("AB - CD",2)}

Output:
          AB - CD
          -------
             2

This macro declares its own control characters, but to call it from a
text line you obviously must have turned on "{".



SCRIPTS
_______


I-B.  It turns on  the standard subscripting and  underlining control
characters:
          ↑ ↓ [ ] & _ ∪



GREEKS
______


I-C.  It turns on the standard line-formatting control charcters:

                                 I.1
June 6, 1972                          MACROS DECLARED IN `PUBMAC.DFS'


          { ∂ \ α β # ← → ∞



FORMAT
______


I-D.  It calls both SCRIPTS and GREEKS.



STANDARD FRONT(SECPRINT, SSPRINT, PAGEPRINT, INDEXCHAR)
________ _______________ ________ __________ __________


I-E.  If SECPRINT  is non-null,  this macro declares  for you  a unit
called SECTION whose PRINTING pattern is SECPRINT.  It  also declares
a macro  called SEC that  should be called  at the beginning  of each
section.  SEC is described later in this document.

If SSPRINT  is non-null, this  macro declares for  you a  unit called
SUBSECTION that is IN SECTION and whose PRINTING pattern  is SSPRINT.
It  also declares  a macro  called SS  that should  be called  at the
beginning  of  each  subsection.   SS  is  described  later  in  this
document.

If PAGEPRINT  is non-null, this  macro declares for  you a  unit PAGE
that is IN SECTION and whose printing clause uses PAGEPRINT.

This macro also  makes preparations for a  table of contents  that is
generated by the macros SEC and SS and that can be printed  using the
macro STANDARD BACK (described next).

If INDEXCHAR is non-null, then  it must be a single  character, e.g.,
"%".  This  macro automatically  declares for  you a  signal response
that lets you send a phrase to the INDEX by bracketing it on the left
and right by  INDEXCHAR.  The macro STANDARD  BACK must be  called at
the end of the document to actually print the index.

Example: The document you are reading began with the  following macro
call:
           .STANDARD FRONT("I", "!-A", "!.1")

The section you are reading began with the following two macro calls:
           .SEC MACROS AUTOMATICALLY DECLARED BY PUB
           .SS |FRACTION(NUMERATOR,DENOMINATOR)|




                                 I.2
June 6, 1972                          MACROS DECLARED IN `PUBMAC.DFS'


STANDARD BACK
________ ____


I-F.  If  you  called  STANDARD  FRONT  at  the  beginning   of  your
manuscript, then you should call STANDARD BACK at the end.  It has no
arguments.  It prints the index (if you asked STANDARD FRONT for one)
and it prints the table of contents.

STANDARD  FRONT  sets  some  global  variables  that   STANDARD  BACK
examines.  There names are SUBBING and INDEXING.







































                                 I.3
June 6, 1972


                             SECTION II
                             _______ __

                 MACROS DECLARED BY `STANDARD FRONT'
                 ______ ________ __ _________ ______




See the previous section to learn about the macro STANDARD FRONT.  It
may declare the following macros for you.



SEC(NAME)
_________


II-A.  It goes to  a new page, counts  up the section  number, prints
titles as exemplified by the document you are reading, and  sends the
information to the table of contents.

It also  sets the  global variable  SECNAME to  NAME, which  might be
useful for  producing headings.  This  document began with  the macro
calls:
           .EVERY HEADING({DATE},,{SECNAME})
           .EVERY FOOTING(,{PAGE!})

SECNAME is  actually set  to NULL before  the first  page of  the new
section is begun.   After the titles are  printed, then it is  set to
NAME.  When the first page of the table of contents and the index are
begun, SECNAME is set to NULL, but on subsequent pages, it is  set to
"TABLE OF CONTENTS" or "INDEX", as is appropriate.

The NAME may not include quotation marks.  Follow the rules for macro
arguments explained in PUB.DOC[S,DOC].



SS(NAME)
________


II-B.  It goes to  a new page  only if there  are fewer than  7 lines
left on the  current page, otherwise it  skips three lines.   Then it
sends an entry to the  table of contents and prints the  section name
and number in the form appearing in this document.

It  also sets  the global  variable SSNAME  to NAME,  which  might be
useful for producing headings.   Macro SEC sets SSNAME to  NULL.  The
NAME may  not contain  quotation marks  (but it  can be  bracketed by
them).

                                II.1